home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Commodities / MUIMousoMeter / docs / english / MousoMeter.doc next >
Text File  |  1996-09-26  |  17KB  |  487 lines
  1.  
  2.  
  3.                          M o u s o m e t e r  V3.13
  4.  
  5.                                   for MUI
  6.  
  7.                   © by Wolfgang Breyha and Michael Matzl
  8.  
  9.                                 in 1993-95
  10.  
  11.                                SCHNITZELWARE
  12.  
  13.  
  14.        Inhalt
  15.        ------
  16.  
  17.            Copyright         
  18.            Introduction      
  19.            Requirements      
  20.            Start             
  21.            About Window      
  22.            Highscores        
  23.            Mousebuttons      
  24.            Button Records    
  25.            Calibration       
  26.            Shortcuts         
  27.            Future & Authors  
  28.            Thanks            
  29.            History           
  30.  
  31.  
  32.  
  33. Copyright:
  34. ----------
  35.  
  36.                          M o u s o m e t e r  V3.13
  37.  
  38.                                   for MUI
  39.  
  40.                   © by Wolfgang Breyha and Michael Matzl
  41.  
  42.                                 in 1993-95
  43.  
  44.  
  45.  
  46. MousoMeter is SCHNITZELWARE!
  47.  
  48. This means if you are using MousoMeter for more than 200 meters, you have
  49. to send the money for a "Wiener Schnitzel" and a beer to one of the two
  50. authors (at the time 15DM or 10US$). And guys that's no joke!!
  51.  
  52.               COPYRIGHT AND DISTRIBUTION
  53.  
  54. MousoMeter is (C) 1993-95 Wolfgang Breyha & Michael Matzl.
  55.  
  56. Permission is granted to make and distribute verbatim copies of this
  57. manual provided the copyright notice and this permission notice are
  58. preserved on all copies.
  59.  
  60. No guarantee of any kind is given that the program described in this
  61. document is 100 % reliable. You are using this material at your own
  62. risk. The authors CAN NOT be made responsible for any damage which is
  63. caused by using this program.
  64.  
  65. This package is freely distributable, but still copyright by Wolfgang
  66. Breyha & Michael Matzl. This means that you can copy it freely as long
  67. as you don't ask for a more than nominal copying fee.
  68.  
  69. Permission is granted to include this package in Public-Domain
  70. collections, especially in Fred Fishs Amiga Disk Library (including CD
  71. ROM versions of it). The distribution file may be uploaded to Bulletin
  72. Board Systems or FTP servers. If you want to distribute this program
  73. you MUST use the contents of the original distribution archive
  74. `MUIMousoMeter312.lha'. The archive may be distributed unpacked or packed
  75. with a different archiver, if necessary.
  76.  
  77.  
  78. Introduction:
  79. -------------
  80. MousoMeter meassures the distance you drive with your Mouse on your
  81. Mousepad. For this purpose there are a day and a total counter.
  82.  
  83. MousoMeter also remindes the time it was activ and calculates your
  84. average speed.
  85.  
  86. And last but not least MousoMeter stores all activities of your Mousebuttons.
  87.  
  88.  
  89. Requirements:
  90. -------------
  91. A mouse;-) For middle-button values a three-button-mouse;-)
  92.  
  93. A sofisticated program like MousoMeter makes it nessecary to take
  94. advantage from many functions of Kickstart 2.04 (V37). So it works
  95. only on this or later versions.
  96.  
  97. And Kick 1.3 is dead! If you are a real AMIGA-User take 2.0 or higher.
  98.  
  99. If you are owner of a release V38+ (Workbench 2.1) you are able to
  100. use the catalogfiles for your prefered language. Possible languages are
  101. at the time:
  102.     english (built in)
  103.     deutsch
  104.     italiano
  105.  
  106. If you are able to help as translating them into other languages read
  107. the section Future.
  108.  
  109. For this release of MousoMeter you also need MUI 2.2 from Stefan Stunz.
  110. (see ReadMe.MUI)
  111.  
  112. In any case you need the following files:
  113.    Fonts/topaz/11
  114.    Fonts/topaz.font
  115.    libs/commodties.library
  116.    libs/diskfont.library
  117.    libs/iffparse.library
  118.    libs/mathieeedoubbas.library
  119.    libs/muimaster.library
  120.    libs/rexxsyslib.library
  121.  
  122. Users of V37 & V38 also need the following statement in
  123. the user-startup:
  124.     assign libs: sys:Classes add
  125.  
  126.  
  127. Startup:
  128. --------
  129. You can start MousoMeter from CLI or Workbench. The recommended way is, to copy
  130. it to the WBStartup drawer.
  131.  
  132. The TOOLTYPES and CLI-options are equal. They are:
  133. CX_PRIORITY      look at the Workbench manual
  134. SAVE_DISTANCE    every time you drive this distance MousoMeter will save
  135.                  the counters for safety
  136. CALIBRATION      the calibration faktor of your mouse (see Calibration)
  137. HANDLERPRI       the priority of the input-handler (should be >55)
  138. MAXDATEDIFF      if the systemdate is greater then the last safed +
  139.                  MAXDATEDIFF MousoMeter will ask you to check your
  140.                  systemclock. If the systemdate is lower then the last
  141.                  safed MousoMeter reacts in the same way.
  142.  
  143. RESETHANDLER     * WARNING * WARNING * WARNING * WARNING * WARNING * WARNING *
  144.  
  145.                  This function is very risky if you don't know how to handle it.
  146.                  So if you know nothing about reset-handlers from the keyboard.-
  147.                  device set it to OFF. This function can cause read/write errors
  148.                  or not validated medias!! The authors know about the risks (and
  149.                  also about the goods) of this function but we take no 
  150.                  responsibility for any damages. YOU HAVE BEEN WARNED!
  151.  
  152. RESETDELAY       After saving the file in the reset-handler MousoMeter must
  153.                  delay the reset to give DOS a chance to write the bitmap to
  154.                  the drive. The value defaults to 150/50 secs (3 secs). If the
  155.                  delay is to short the errors described in the upper section may
  156.                  occure. On my configuration (W. Breyha) a delay of 75 is enough.
  157.                  (A2000+GVP Serie II 030 33Mhz+Quantum LPS 240)
  158.  
  159.                  * WARNING * WARNING * WARNING * WARNING * WARNING * WARNING *
  160.  
  161. The standard Commodity-Tooltypes POPUP and POPKEY are not supported, because
  162. they are configured in MUI's Preferences-program.
  163.  
  164. There're no more Window coordinates, because they're configured in with the MUI-
  165. Prefs Editor!!
  166.  
  167.  
  168. About Window:
  169. -------------
  170.  
  171. Here you can see general Informations about MousoMeter and your achieved scores.
  172. You can see how long MousoMeter was active and your average speed in meters/hour.
  173. The values from "last time" are those from the last day MousoMeter was active.
  174.  
  175.  
  176. Highscore Tables:
  177. -----------------
  178.  
  179. This table shows the three best and the three worst scores you have achieved in
  180. the three categories uptime, distance and avarage speed.
  181.  
  182.  
  183. Mousebutton window:
  184. -------------------
  185.  
  186. Here you can see how often you have pressed the buttons of your mouse.
  187. For each of Last, Today and Total you have also an average value in klicks/hour.
  188.  
  189.  
  190. Button Records:
  191. ---------------
  192.  
  193. This table shows the three best and the three worst scores you have achieved with
  194. your three mousebuttons.
  195.  
  196.  
  197. Calibration:
  198. ------------
  199.  
  200. Select "Calibration..." in the MousoMenu.
  201.  
  202. A window will ask you to hold down your left button. Then move your mouse exactly
  203. 10 cm horizontal on your mousepad (not on the monitor) still holding the button.
  204. After that release it. MousoMeter now tells you the new calibration-factor.
  205. If you press the RESET-button in the requester MousoMeter will set back all
  206. counters. If you select OK only the new faktor is stored without reset of
  207. counters.
  208.  
  209. After that select "Save Prefs" in the MousoMenu to save the calibration-faktor
  210. into the .info-file.
  211.  
  212.  
  213. Shortcuts:
  214. ----------
  215.  
  216. right AMIGA + Q -> Quit
  217. right AMIGA + H -> Hide (Iconify)
  218.  
  219. right AMIGA + A -> About
  220. right AMIGA + S -> Highscores
  221. right AMIGA + B -> Mousebuttons
  222. right AMIGA + R -> Mousebutton records
  223.  
  224.  
  225. Future & Authors:
  226. -----------------
  227.  
  228. If you speek a language which is not supported and you will
  229. make a translation file for us, write to one of the addresses below.
  230.  
  231. To make a translation file, you must take the MousoMeter_empty.ct file
  232. and translate all the english sentences in your language. The english
  233. definition is always commented with a ";" below stands the alias for
  234. the C-Code. And below is a empty line. There you must write your
  235. translation. Take a look at the german .ct file for example. You also
  236. have to take care about some limits! Take the MousoMeter.cd file and look
  237. at the parts looking like (?/?/?). If it is (//) there're no limits!
  238. The format is exactly (string_id/min_chars/max_chars). String_id is
  239. not very important for you, but you have to take care about the other
  240. two values! Also take care about the list headers!
  241. If there are default lines like "o0Ok", you must also generate a line
  242. in this format! The first character is the Hotkey of this button
  243. (the underlined character) The "0" is very important to split
  244. the hotkey from the Button text!
  245.  
  246. When you have translated the .ct file into your language call it
  247. MousoMeter.ct.(your language) (eg. MousoMeter.ct.sweden) and send it
  248. to one of the authors (per email or normal mail)
  249.  
  250. The authors:
  251. ------------
  252. Wolfgang Breyha        email to: e9025856@stud1.tuwien.ac.at
  253. Großer Ring 42         IRC-Nick: MASH
  254. 1130 WIEN
  255. Österreich
  256.  
  257. Michael Matzl
  258. Maurer-Langegasse 57/1/4
  259. 1238 WIEN
  260. Österreich
  261.  
  262.  
  263. advertisments:
  264. --------------
  265. If you like Mousometer try to get the other projects of the authors!!
  266.  
  267. D.E.R. ST-Player (STP) © Wolfgang Breyha
  268.     A Soundtracker-Moduleplayer with a GUI like a real CD-Player.
  269.     Many features like nonstop playing, random, programmable.
  270.  
  271. Plot 3D © Michael Matzl
  272.     A very good 3D function-plotter with Kick 2.0 GUI.
  273.  
  274.  
  275. coming soon:
  276.  
  277. .....Meter:
  278.     ask Markus Illenseer (IRC Nick: Ill) He asked me about it in Köln.
  279.  
  280.  
  281. Thanks to:
  282. ----------
  283.  
  284.                 Reinhardt Franz(Killersoft), Dieter Henkel, Peter Scherbaum
  285.  
  286.                 for beta-testing, bugreports, good ideas and very good friendship.
  287.  
  288.                 following MousoMeter-Fans, which have sent Mail:
  289.                 (sorted by date of first mail)
  290.                 Michael Thiel     , Deutschland, 16 Sep 93 14:43
  291.                 Christian Carlsson, Schweden   , 16 Sep 93 20:44
  292.                 Stefano Peruzzi   , Italien    ,  2 Jun 94 22:02
  293.                 Tetsuo            , Finnland   , 13 Aug 94 12:58
  294.  
  295.                 to all people sending me standard mail
  296.                 Tobias Ferber     , Deutschland
  297.                 Bernd Schäfer     , Deutschland
  298.                 Kristoffer Larsson, Schweden
  299.                 Michael Petrikowski, Deutschland, (Amiga Szene PD)
  300.  
  301.                 to all guys I have met in Köln giving me power for
  302.                 new MousoMeter versions (special thanks to Markus
  303.                 Ill Illenseer) and to start the next ?Meter project.
  304.  
  305.                 to all of you sending me bugreports, ideas, funny mails,
  306.                 money for a Schnitzel or other gifts.
  307.                 
  308.                 Special thanks to Stefan Stunz, the father of MUI. I hope
  309.                 for all AMIGA-Fans that MUI is the standart of the future.
  310.                 
  311.                 to VillageTronic for the Picasso II.
  312.                 
  313.                 to F.G.T.H for all their Maxi-Singles.
  314.  
  315.                 to Citroen for the 2CV, my current car.
  316.  
  317.                 to Robert Altman for MASH, the best film ever in cinema.
  318.  
  319.                 to mom and dad for .....
  320.  
  321.                                                    //
  322.                 Commodore for development of the \X/AMIGA.
  323.                                           
  324.                 and never forget: Intel outside!!
  325.  
  326.  
  327. /* $Revision Header built automatically *************** (do not edit) ************
  328. **
  329. ** © Copyright by Modern Art Soft Hietzing
  330. **
  331. ** File             : MUIMouso.c
  332. ** Created on       : Saturday, 03.07.93 18:37:57
  333. ** Created by       : Wolfgang Breyha & Michael Matzl
  334. ** Current revision : V3.13
  335. **
  336. **
  337. ** Purpose
  338. ** -------
  339. **   - Commoditiy for meassuring mouse-movement in kilometers
  340. **
  341. ** Revision V3.13
  342. ** --------------
  343. ** created on Thursday, 20.04.95 01:57:49  by  Wolfgang BREYHA.   LogMessage :
  344. **   - Hotkeys for MUI Requesters added (catalogs)
  345. **     Communication with other *Meter Products to avoid
  346. **     multiple Checkdate Requesters
  347. **
  348. ** Revision V3.12
  349. ** --------------
  350. ** created on Thursday, 15.09.94 12:32:14  by  W.Breyha & M.Matzl.   LogMessage :
  351. **   - MousoMeter uniconfies now if a requester is coming up
  352. **     Bug in Save Prefs corrected; Sourceupdate to MUI 2.2
  353. **     Italian catalog included
  354. **
  355. ** Revision V3.11
  356. ** --------------
  357. ** created on Tuesday, 24.05.94 22:48:21  by  W.Breyha & M.Matzl.   LogMessage :
  358. **   - About-Window fixed for non-laced WB
  359. **
  360. ** Revision V3.10
  361. ** --------------
  362. ** created on Wednesday, 02.03.94 00:34:56  by  Wolfgang BREYHA.   LogMessage :
  363. **  -*-  changed on Tuesday, 08.03.94 21:49:48  by  Wolfgang BREYHA.   LogMessage :
  364. **   - Bug in loadroutine removed (date of first use of 3.09
  365. **     was not stored correctly!)
  366. **  -*-  created on Wednesday, 02.03.94 00:34:56  by  Wolfgang BREYHA.   LogMessage :
  367. **   - All EasyStruct Requesters changed to MUI Requesters
  368. **
  369. ** Revision V3.09
  370. ** --------------
  371. ** created on Monday, 28.02.94 01:01:42  by  W.Breyha & M.Matzl.   LogMessage :
  372. **  -*-  changed on Monday, 28.02.94 11:29:06  by  Wolfgang BREYHA.   LogMessage :
  373. **   - Ignore button in both checkdate requesters now.
  374. **     Minor bug in button window removed (no timeupdate)
  375. **  -*-  created on Monday, 28.02.94 01:01:42  by  W.Breyha & M.Matzl.   LogMessage :
  376. **   - Problem with average button values fixed (time of 1st usage
  377. **     of buttons saved)
  378. **
  379. ** Revision V3.08
  380. ** --------------
  381. ** created on Thursday, 17.02.94 12:29:23  by  Wolfgang BREYHA.   LogMessage :
  382. **  -*-  changed on Sunday, 20.02.94 23:48:49  by  Wolfgang BREYHA.   LogMessage :
  383. **   - Bug in Resethandler removed (only IORequest not IOStdReq
  384. **     allocated); code for Helpfile-detection removed since MUI
  385. **     does it itself;
  386. **  -*-  created on Thursday, 17.02.94 12:29:23  by  Wolfgang BREYHA.   LogMessage :
  387. **   - Button-Highscores included
  388. **
  389. ** Revision V3.07
  390. ** --------------
  391. ** created on Tuesday, 15.02.94 12:55:11  by  Wolfgang BREYHA.   LogMessage :
  392. **   - Timerrequest changed; new day recognized exactly at 24h now
  393. **     Resethandler added
  394. **
  395. ** Revision V3.06
  396. ** --------------
  397. ** created on Monday, 14.02.94 20:45:20  by  W.Breyha & M.Matzl.   LogMessage :
  398. **   - CX_PRIORITY is supported now
  399. **     Mousebutton-Statistic added
  400. **     Last values added
  401. **     helpfile location localized
  402. **
  403. ** Revision V3.05
  404. ** --------------
  405. ** created on Sunday, 13.02.94 23:17:25  by  Wolfgang Breyha.   LogMessage :
  406. **   - localized
  407. **     Ok shortcut in About and HighScore Window enabled
  408. **     Save Prefs enabled (don't know why it was disabled ;-)
  409. **     Activate, Disable corrected (no timeupdate)
  410. **
  411. ** Revision V3.04
  412. ** --------------
  413. ** created on Sunday, 30.01.94 16:54:16  by  Michael Matzl.   LogMessage :
  414. **   - Online help included
  415. **     History in documentation included
  416. **
  417. ** Revision V3.03
  418. ** --------------
  419. ** created on Wednesday, 19.01.94 00:13:10  by  W.Breyha & M.Matzl.   LogMessage :
  420. **  -*-  changed on Thursday, 20.01.94 16:56:49  by  Wolfgang BREYHA.   LogMessage :
  421. **   - cosmetic sourcechanges, date-check improved
  422. **     MM uses now .info-file as iconify-icon
  423. **  -*-  created on Wednesday, 19.01.94 00:13:10  by  W.Breyha & M.Matzl.   LogMessage :
  424. **   - Systemdate-check included
  425. **
  426. ** Revision V3.02
  427. ** --------------
  428. ** created on Sunday, 07.11.93 20:32:23  by  Michael Matzl.   LogMessage :
  429. **   - Window-Activation at startup disabled
  430. **     save every time at startup
  431. **
  432. ** Revision V3.01
  433. ** --------------
  434. ** created on Friday, 17.09.93 20:47:03  by  Michael Matzl.   LogMessage :
  435. **   - (In)active signals from Exchange activated:)
  436. **     Cosmetic changes in About Window
  437. **     Iconfiy Image included
  438. **     some bugfixes
  439. **
  440. ** Revision V3.00
  441. ** --------------
  442. ** created on Monday, 06.09.93 01:30:00  by  Wolfgang BREYHA.   LogMessage :
  443. **   - Totaly new version using the brand new MUI from Stefan Stunz
  444. **
  445. ** Revision V2.01
  446. ** --------------
  447. ** created on Saturday, 04.09.93 13:44:12  by  Wolfgang BREYHA.   LogMessage :
  448. **   - Bug in highscoretable removed
  449. **
  450. ** Revision V2.00
  451. ** --------------
  452. ** created on Wednesday, 01.09.93 15:27:35  by  Wolfgang BREYHA.   LogMessage :
  453. **   - Autosave to .info-file for calibration, window x,y
  454. **     Measures uptime too now. Aboutrequester changed.
  455. **     Highscorelist included. Timer.device for newday-check.
  456. **     Removed many bugs
  457. **
  458. ** Revision V1.10
  459. ** --------------
  460. ** created on Wednesday, 25.08.93 00:09:20  by  Michael Matzl.   LogMessage :
  461. **   - Inputhandler add
  462. **
  463. ** Revision V1.02
  464. ** --------------
  465. ** created on Wednesday, 14.07.93 21:38:32  by  Michael Matzl & Wolfgang Breyha.   LogMessage :
  466. **   - Added Calibration-routine
  467. **     didn't save kilometers when window hidden
  468. **
  469. ** Revision V1.01
  470. ** --------------
  471. ** created on Wednesday, 07.07.93 17:04:48  by  Michael Matzl.   LogMessage :
  472. **  -*-  changed on Thursday, 08.07.93 00:37:01  by  Michael Matzl.   LogMessage :
  473. **   - Enforcer-Hit fixed
  474. **  -*-  created on Wednesday, 07.07.93 17:04:48  by  Michael Matzl.   LogMessage :
  475. **   - Bug fixed in CalcKM-routine (y-axis not considered)
  476. **     click on close-gadget hides window
  477. **     saved 0 km when started again
  478. **     menu added
  479. **
  480. ** Revision V1.00
  481. ** --------------
  482. ** created on Saturday, 03.07.93 18:37:57  by  W.Breyha & M.Matzl.   LogMessage :
  483. **     --- Initial release ---
  484. **
  485. *********************************************************************************/
  486.  
  487.